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FIG. 3A ^3oo 

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"> 
<Header> 
<!-- user data --> 
</Header> 
<Body> 
<!- user data --> 
</Body> 
</Envelope> 



FIG. 3B 




<SOAP-ENV:Header> 
<t:Transaction 

xmlns:t="some-URI" SOAP-ENV:mustUnderstand="1"> 
5 

</t:Transaction> 
</SOAP-ENV:Header> 
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FIG. 4A 




BSTR HelloWorld(BSTR inputString) 
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FIG. 4C 



450 



POST/HelloWorld HTTP/1.1 
Host: <someserver> 
Content-Type: text/xml 
Content-Length: nnnn 
SOAPAction: "Some-URI" 



<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"> 
<Body> 

<HelloWorld xmlns="Some-URI M > 
<inputString>StringValue</inputString> 
</HelloWorld> 
</Body> 
</Envelope> 



FIG. 4D 



455 



HTTP/1.1 200 OK 
Content-Type: text/xml 
Content-Length: nnnn 



<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/"> 
<Body> 

<HelloWorldResponse xmlns= M Some-URI"> 
<return>Hello StringValue</return> 
</HelloWorldResponse> 
</Body> 
</Envelope> 
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FIG.4E V 

#define _WIN32_WINNT 0x0500 
#define _ATL_ATTRIBUTES 
#include <atlsoap.h> 

[ module(name="HelloWorid") ]; 

[ uuid("643cd054-24b0-4f34-b4a1 -64251 9836ef9"), object ] 
interface IHelloWorld 

{ 

[id(1)l HRESULT HelloWorld( 
[in] BSTR inputString, 
[out, retval] BSTR *retval); 

}; 

[ 

request_handler( 

name="Default", 

sdl="sdl"), 
soap_handler( 

name="HelloWorld", 

namespace="http://atlserver/soap/HelloWorld", 
protocol="soap") 

] 

class CHelloWorld : public IHelloWorld 
{ 

public: 

[ soapjnethod ] 
HRESULT HelloWorld( 

BSTR inputString, 

BSTR *retval) 

{ 

CComBSTR bstrRet(L"Hello "); 
bstrRet += inputString; 

*retval = bstrRet.Detach(); 

return S_OK; 

} 

}; 
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500 



[ uuidfuuid"), object ] 

interface Interface 

{ 

[id(1)] HRESULTsoapMethod1([idl_attributes] typel parameter"!, 
[idl_attributes] type2 parameter2, 
[idl_attributes] typeN parameterN); 



}; 



[id(2)] HRESULTsoapMethod2([idl_attributes] typel parameteM, 
[idl_attributes] type2 parameter2, 
[idl_attributes] typeN parameterN); 



5 



[ requestjiandier, soap_handler ] 
class CCIass : public Interface 

{ 

public: 

typel header!; FIC^ 
type2 header2; 1 lw - 

//... 

typeN headerN; 

[ soap_method(name= ,, wsdlName H ) ] 
[ soap Jieader(value="headerr, 

in="true|false n , 

out="true|false", 

required="true|false") 

] 

HRESULTsoapMethodl (typel parameteM 

type2 parameter2, 
typeN parameterN) 

{ 

// user code 

} 

[ soap_method(name="wsdIName2") ] 
[ soapJieader(value="headerl", 
in="true|false" J 
out="true|false M , 
required= ,, true|false") 

] 

HRESULT soapMethod2 (typel parameter! 

type2 parameter2, , 
typeN parameterN) 

{ 

// user code 

} 
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FIG. 6 
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[ uuid("643cd054-24bO-4f34-b4a1 -64251 9836fe8"), object] 
interface Interface 

{ 

[id(1)] HRESULT method1([in] bool blnput, [out, retval] bool *bOutput); 

}; 

[ request_handler, soap_handler ] 
class CCIass : public Interface 
{ 

[ soap_method ] 

HRESULT method 1 (bool blnput, bool *bOutput) 
{ 

*bOutput = Sblnput; 
return S_OK; 

} 

}; 



struct 
{ 



CCIass method 1 struct 



bool blnput; 
bool bOutput; 



}; 



Docket No.: MSFT-0670/1 80589.1 
Inventors: P. Ringseth, M. Al-Gosien, J. Grewel 
Filing Date. July 10, 2001 
Serial No.: Not yet assigned 

Title: System and Methods for Providing a Declarative 
Syntax for Specifying SOAP-based Web Services 
Page 9 of 31 



700 



FIG. 7A 



extern declspec(selectany) const _soapmapentry 

CCIass_method1_entries[] = 

{ 



0x38998673, 

"bOutput", 

L"bOutput", 

sizeof("bOutput")-1 , 

SOAPTYPE_BOOLEAN, 

SOAPFLAG_RETVAL | SOAPFLAG_OUT, 

offsetof( CCIass_method1_struct, bOutput), 

NULL, 
NULL, 
-1, 



705 



r 

FIG 
7B 



{ 

0xEA00C812, 

"blnput", 

L"blnput", 

sizeof("blnput")-1, 

SOAPTYPE_BOOLEAN, 

SOAPFLAG_NONE | SOAPFLAGJN, 

offsetof( CCIass_method1_struct, blnput), 

NULL, 
NULL, 
-1, 

}. 

{ 0x00000000 } 
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extern declspec(selectany) const _soapmap 

CCIass_method1_map = ^710 



{ 



}; 



0xDC7296CC, 

"method 1", 

L"method1", 

sizeof( M methodr)-1, 

sizeof("method1")-1, 

SOAPMAP_FUNC, 

CCIass_method 1 _entries, 

sizeof( CCIass_method1_struct), 

1, 
0 



FIG. 7C 



extern declspec(selectany) const _soapmapentry ^715 

CCIass_method1_atlsoapheader_entries[] = ' 

{ 

{ 0x00000000 } 

}; 



FIG. 7D 
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extern declspec(selectany) const _soapmap 

CCIass_method 1 _atlsoapheader_map = 

{ 

0xDC7296CC, 

"method 1", 

L"methodr, 

sizeof("method1")-1, 

sizeof("method1")-1, 

SOAPMAP_HEADER, 

CCIass_method1_atlsoapheader_ent 

ries, 

0, 
0, 
-1 

y 



extern 
{ 

}; 


declspec(selectany) const soapmap * 


CCIass funcs[] = 


& CCIass methodl map, 
NULL 




extern 
{ 

}; 


declspec(selectany) const soapmap * 


CCIass headers[] = 


& CCIass methodl atlsoapheader map, 
NULL 





s- 720 

FIG. 7E 



FIG. 7F 
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^800 

ATL_NOINLINE inline const _soapmap ** CCIass::GetFunctionMap() 
{ 

return CCIassjFuncs; 

}; 

ATL_NOINLINE inline const _soapmap ** CCIass::GetHeaderMap() 
{ 

return CCIassJneaders; 

} 

ATL_NOINLINE inline void * CCIass::GetHeaderValue() 
{ 

return this; 

} 



FIG. 8A 
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FIG. 8B 
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ATL_NOINLINE inline HRESULT CCIass::CallFunction( 
void *pvParam, 

const wcharj *wszl_ocalName, 
int cchLocalName, 
size_t nltem) 

{ 

wszLocalName; 
cchLocalName; 

HRESULT hr = S_OK; 

switch(nltem) 
{ 

case 0: 
{ 

CCIass_method1_struct *p = ( CCIass_method1_struct *) pvParam; 

hr= method 1(p->blnput, &p->bOutput); 
break; 

} 

default: 

hr = EFAIL; 

} 

return hr; 

}s 

ATL_NOINLINE inline const wcharj * CCIass::GetNamespaceUri() 
{ 

return L"http://atlserver/soap/test"; 

} 

ATL NOINLINE inline const char * CCIass::GetNamespaceUriA() 
{ 

return "http://atlserver/soap/test"; 

} 

ATL_NOINLINE inline const char * CCIass::GetServiceName() 
{ 

return "SoapTest"; 

} 
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FIG. 9 
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[ uuid("643cd054-24b0-4f34-b4a1 -64251 9836fe8 n ), object] 
interface Interface 

{ 

[id(1)] HRESULT method1([in] bool blnput, [out, retval] bool 

*bOutput); 

}; 

[ request_handler, soap_handler ] 
class CCIass : public Interface 

{ 

int Headeri ; 
[ soapjmethod ] 

[soap_header(value="Header1", in="true", out="false", 
required-'false")] 

HRESULT method 1 (bool blnput, bool *bOutput) 
{ 

*bOutput = Iblnput; 
return S_OK; 

} 

}; 



struct 
{ 



CCIass method 1 struct 



}; 



bool blnput; 
bool bOutput; 
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FIG. 10A 



extern declspec(selectany) const _soapmapentry 

CCIass_method1_entries[] = 

{ 



0x38998673, 

"bOutput", 

U'bOutput", 

sizeof("bOutput")-1, 

SOAPTYPE_BOOLEAN, 

SOAPFLAG_RETVAL | SOAPFLAG_OUT, 

offsetof( CCIass_method 1_struct, bOutput), 

NULL, 
NULL, 

-1, 



1005 



r 



FIG. 
10B 



{ 

0xEA00C812, 

"blnput", 

L"blnput", 

sizeof("blnput")-1, 

SOAPTYPE_BOOLEAN, 

SOAPFLAG_NONE | SOAPFLAGJN, 

offsetof ( CCIass_method 1_struct, bl nput), 

NULL, 
NULL, 

-1, 

}. 

{ 0x00000000 } 

}; 
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extern declspec(selectany) const _soapmap 

CCIass_method1_map = 



{ 



}; 



0xDC7296CC, 

"method 1", 

L"method1", 

sizeof("method1")-1, 

sizeof("method1")-1, 

SOAPMAP_FUNC, 

CCIass_method1_entries, 

sizeof( CCIass_method1_struct), 

1, 
0 



r 



1010 



FIG. 
10C 



extern declspec(selectany) const _soapmapentry 

CCIass_method 1 _atlsoapheader_entries[] = 



{ 



{ 



0xFAD45C89, 
"Headerl", 
U'Headerl", 
sizeof( M Header1")-1, 
SOAPTYPE_INT, 
SOAPFLAG_NONE | 
SOAPFLAGJN, 

offsetof(CCIass, Headerl), 

NULL, 

NULL, 

-1, 

}, 

{ 0x00000000 } 

}; 



Y 



015 



FIG. 
10D 



Docket No.: MSFT-0670/1 80589.1 
Inventors: P. Ringseth, M. Al-Gosien, J. Grewel 
Filing Date: July 10, 2001 
Serial No.: Not yet assigned 

Title: System and Methods for Providing a Declarative 
Syntax for Specifying SOAP-based Web Services 
Page 17 of 31 



extern declspec(selectany) const _soapmap 

CCIass_method1_atlsoapheader_map = 



{ 



ries, 



}; 



r 



1020 



0xDC7296CC, 

"methodl", 

L"methodr, 

sizeof("method1")-1, 

sizeof("method1")-1, 

SOAPMAP_HEADER, 

CCIass_method1_atlsoapheader_ent 



0, 
0, 
-1 



FIG. 
10E 



extern declspec(selectany) const _soapmap 

CCIass_funcs[] = 



1 025 



{ 



}; 



& CCIass_method 1 _map, 

NULL 



r FIG. 
10F 



extern declspec(selectany) const _soapmap 

CCIass_headers[] = 



{ 



}; 



& CCIassjnethod 1 _atlsoapheader_map, 

NULL 
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^1100 

ATL_NOINLINE inline const _soapmap ** CCIass::GetFunctionMap() 
{ 

return CCIass_funcs; 

}; 

ATL__NOINLINE inline const _soapmap ** CCIass::GetHeaderMap() 
{ 

return CCIass_headers; 

} 

ATL_NOINLINE inline void * CCIass::GetHeaderValue() 
{ 

return this; 

} 



FIG. 
11A 
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ATL_NOINLINE inline HRESULT CCIass::CailFunction( 
void *pvParam, 

const wcharj: *wszLocalName } 
int cchLocalName, 
size J: nltem) 

{ 

wszLocalName; 
cchLocalName; 



HRESULT hr = S_OK; 



switch (nltem) 

{ 

case 0: 
{ 

CCIass_method1_struct *p = ( CCIass_method1_struct *) pvParam; 

hr = method1(p->blnput, &p->bOutput); 
break; 

} 

default: 

hr = E_FAIL; 

} 

return hr; 

}s 

ATL_NOINLINE inline const wcharj * CCIass::GetNamespaceUri() 
{ 

return L"http://atlserver/soap/test"; 

} 



ATLNOINLINE inline const char * CCIass::GetNamespaceUriA() 
{ 

return "http://atlserver/soap/test"; 

} 

ATL_NOINLINE inline const char * CCIass::GetServiceName() 
{ 

return "SoapTest"; 

} 
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FIG. 12 



■1200 



[ export ] 

enum TestEnum { Test_Zero, Test_One, Test_Two, Test_Three, Test_Four }; 

[ export ] 
typedef struct 
{ 

int n; 
double d; 
BSTR s; 
int arr[2][4]; 
} TestStruct; 

[ uuid("643cd054-24b0-4f34-b4a1 -64251 9836fe8"), object ] 
interface Interface 

{ 

[id(1)] HRESULT method1([in] TestStruct t, [out, retval] 

TestEnum *e); 

}; 

[ requestjiandler, soap_handler ] 
class CCIass : public Interface 
{ 

[ soapjmethod ] 

HRESULT method 1 (TestStruct , TestEnum *e) 

{ 

// user code ... 

} 

}; 



Docket No.: MSFT-0670/1 80589.1 
Inventors: P. Ringseth, M. Al-Gosien, J. Grewel 
Filing Date: July 10, 2001 
Serial No.: Not yet assigned 

Title: System and Methods for Providing a Declarative 
Syntax for Specifying SOAP -based Web Services 
Page 21 of 31 



FIG. 13A 



1300 



if_not_exists( TestEnum_entries) 

{ 

extern declspec(selectany) const _soapmapentry TestEnum_entries[] = 

{ 

{ 0x1 8AD26DB, "Test_Four", L"Test_Four", sizeof("Test_Four")-1 , 4, 
SOAPFLAG_FIELD, 0, NULL, NULL, -1 }, 

{ 0x2F4B7497, "Test_Three", L"Test_Three", sizeof("Test_Three")-1 , 3, 
SOAPFLAGFIELD, 0, NULL, NULL, -1 }, 

{ 0xF8FDB9D9, "Test_Two", L"Test_Two", sizeof("Test_Two")-1 , 2, 
SOAPFLAG FIELD, 0, NULL, NULL, -1 }, 

{ 0xF8FDA361, "Test_One", L"Test_One", sizeof("Test_One")-1 , 1, 
SOAPFLAG_FIELD, 0, NULL, NULL, -1 }, 

{0x18B7F37F, "Test_Zero", L"Test_Zero", sizeof("Test_Zero")-1, 0, 
SOAPFLAG FIELD, 0, NULL, NULL, -1 }, 

{ 0x00000000 } 

■ ■>; 



^ ^1305 

extern declspec(selectany) const _soapmap TestEnum_map = 

{ 

0xF8EFE655, 

"TestEnum", 

L'TestEnum", 

sizeof("TestEnum")-1 , 

sizeaf( , TestEnum")-1 l 

SOAPMAP_ENUM, 

^TestEnum_entries, 

sizeof(: TestEnum), 

1, 
-1 

}; 

} 



FIG- 13B 
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_if_not_exists( TestStruct_entries) 

{ 

extern declspec(selectany) const int TestStruct_arr_dims[] = {2, 2, 4, }; 

extern declspec(selectany) const _soapmapentry TestStruct_entries[] = 

{ 



{ 



}. 
{ 



0x0000006E, 

"n", 

L"n", 

sizeof("n")-1, 

SOAPTYPEJNT, 

SOAPFLAGFIELD, 

offsetof(::TestStruct, n), 

NULL, 

NULL, 

0 



0x00000064, 

"d", 

L"d", 

sizeof("d")-1 , 

SOAPTYPE_DOUBLE, 

SOAPFLAG_FIELD, 

offsetof(::TestStruct, d), 

NULL, 

NULL, 

0 



}. 



FIG. 13C 



FIG. 13D 
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310 



{ 

0x00000073, 

"s", 

L"s", 

sizeof("s")-1, 

SOAPTYPE_STRING, 

SOAPFLAG_FIELD, 

offsetof(::TestStruct, s), 

NULL, 

NULL, 

0 

}, 
{ 

0x000 1ABC5, 

"arr", 

L"arr", 

sizeof("arr")-1, 
SOAPTYPEJNT, 

SOAP FLAG_F I E LD | SOAPFLAG_FIXEDARR, 
offsetof(::TestStruct, arr), 

TestStruct_arr_dims, 

NULL, 
0 

}, 

{ 0x00000000 } 

}; 
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FIG. 13E 
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extern declspec(selectany) const soapmap TestStructjnap = 

{ 

0x15962585, 

"TestStrucf, 

L'TestStruct", 

sizeof("TestStruct")-1, 

sizeof("TestStruct")-1, 

SOAPMAP_STRUCT, 

TestStruct_entries, 

sizeof(::TestStruct), 

4, 

-1 

}; 



^1320 

struct CCIass_method1_struct 

{ 

TestStruct tin; 
TestEnum eOut; 



FIG. 13F 



Docket No.: MSFT-0670/180589.1 
Inventors: P. Ringseth, M. Al-Gosien, J. Grewel 
Filing Date: July 10, 2001 
Serial No.: Not yet assigned 
Title: System and Methods for Providing a Declarative 
Syntax for Specifying SOAP-based Web Services 
Page 25 of 31 



extern declspec(selectany) const _soapmapentry 

CCIass_method1_entries[] = 



{ 



}. 
{ 



0x38998673, 

"edit", 

L"eOut", 

sizeof("eOut")-1, 
SOAPTYPE_UNK, 

SOAPFLAG_RETVAL | SOAPFLAG_OUT, 

offsetof( CCIass_method1_struct, eOut), 

NULL, 

& TestEnumjmap, 

-1. 



0xEA00C812, 

"blnput", 

U'blnput", 

sizeof("blnput")-1, 

SOAPTYPE_UNK, 

SOAPFLAG_NONE | SOAPFLAGJN, 

offsetof( CCIass_method1_struct, tin), 

NULL, 

& TestStructjmap, 

-1. 



r 



}; 



}. 

{ 0x00000000 } 



1325 



FIG. 
13G 



extern declspec(selectany) const soapmap CCIassmethodlmap = 

{ 



.}; 



0xDC7296CC, 
"method 1", 
L"method1", 
sizeof ("method 1")-1, 
sizeof("method1")-1, 
SOAPMAP_FUNC, 

CCIassmethodlentries, 

sizeof ( CCIass_method 1 _struct) , 

1, 
0 



r 



1330 



FIG. 
13H 
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